home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / math / jaw3d22.zip / MODEL.DOC < prev    next >
Text File  |  1996-10-20  |  3KB  |  125 lines
  1.                               jaw3d Model Viewer
  2.  
  3.                           Copyright (c) 1996 Nullsoft
  4.                            programmed by Jawed Karim
  5.  
  6.  
  7. Table of Contents:   [Model File Format]
  8.                      [Controls]
  9.                      [Special Thanks]
  10.                      [Updates & Model Files]
  11.  
  12.  
  13. Model File Format:
  14. ==================
  15.  
  16. Model files are simple text files containing the coordinates and color
  17. of each polygon. Model files must have the extension .j3d to be
  18. accepted by the jaw3d Model Viewer. The general format is:
  19.  
  20. <number of points of polygon> <color of polygon>
  21. <x1> <y1> <z1>
  22. <x2> <y2> <z2>
  23. <x3> <y3> <z3>
  24.  
  25. For example:
  26.  
  27. 4 1
  28. -10 10 0
  29. 10 10 0
  30. 10 -10 0
  31. -10 -10 0
  32.  
  33. This will draw a blue rectangle. A rectangle has four vertices, therefore
  34. the 4. The color code for blue is 1.
  35. You must use the following coordinate system:
  36.  
  37.        +Y 
  38.         |   /
  39.         | /
  40.  -------|------- +X
  41.       / |
  42.     /   |
  43.   +Z
  44.  
  45. The larger you make the polygons the greater is the chance that they will
  46. overlap incorrectly. Therefore, if you see any overlapping problems,
  47. simply divide your polygons up into smaller ones and the problems should
  48. disappear. Especially polygons that are supposed to be covered up by
  49. others should be divided up like this.
  50.  
  51. Note: empty lines in model files will create problems. For seperation or
  52. comments, use the # character. Do NOT place comments between coordinate lines,
  53. only between individual polygon sections.
  54.  
  55. Here is a partial list of color codes. There are 256 different colors you
  56. can use. This list contains only the few colors of which I know the names!
  57.  
  58. BLACK        0
  59. DARKGRAY     8
  60. BLUE         1         
  61. LIGHTBLUE    9
  62. GREEN        2         
  63. LIGHTGREEN   10
  64. CYAN         3
  65. LIGHTCYAN    11
  66. RED          4
  67. LIGHTRED     12
  68. MAGENTA      5
  69. LIGHTMAGENTA 13
  70. BROWN        6
  71. YELLOW       14
  72. LIGHTGRAY    7
  73. WHITE        15
  74.  
  75.  
  76. Controls:
  77. =========
  78.  
  79. Keyboard Controls:
  80.  
  81.     X   rotate the model around the X axis
  82.     Y   rotate the model around the Y axis
  83.     Z   rotate the model around the Z axis
  84.     +   zoom in
  85.     -   zoom out 
  86.        up   move the model up
  87.      down   move the model down
  88.      left   move the model left
  89.      right  move the model right
  90.        ESC quit
  91.     M   switch between wire frame and solid drawing mode
  92.  
  93. Mouse Controls:
  94.  
  95.     up/down/left/right  rotate the model in any given direction
  96.                left button  hold down to move the model's center
  97.               right button  hold down to zoom in and out
  98.  
  99.  
  100. Special Thanks:
  101. ===============
  102.  
  103. Special Thanks go to:
  104.  
  105.     Tom Forsythe <polaris@goldengate.net>
  106.  
  107. For spending the time to create the complex Quake model file and for
  108. many useful suggestions and ideas that have been incorporated into jaw3d.
  109.  
  110.     Shawn Hargreaves
  111.  
  112. For the excellent djgpp graphics library Allegro.
  113.  
  114.  
  115. Updates & Model Files:
  116. ======================
  117.  
  118. You will always find the most recent version of jaw3d at:
  119. http://umn.edu/~kari0022
  120.  
  121. Have you created a neat model file? Let me know about it:
  122. kari0022@gold.tc.umn.edu
  123.  
  124. If I like it I'll add it to the next release of jaw3d.
  125.